What changed

Updated docs/audiences.md to remove Trial workspaces from the list of plans with Clay Audiences access. Specifically:

• Description frontmatter: Removed "and Trial" from "Launch and Trial workspaces can import via CSV…" and added "Trial workspaces do not have access to Audiences."
• Plan availability paragraph (line 9): Changed "Launch and Trial workspaces have access to core Audiences features" → "Launch workspaces have access to core Audiences features". Removed the sentence "Trial workspaces can create up to 250 audience segments; there is no row cap on CSV imports to Audiences on any plan." Changed "Free workspaces and legacy non-Enterprise plans do not have access to Audiences" → "Free, Trial, and legacy non-Enterprise plan workspaces do not have access to Audiences."

Why

A code change in this deploy (c8bdc8a...b5167da) — commit e50042a3 — runs a permanent DB migration that sets enableAudiencesGA = false for all trial billing plans (trial, trialApril2023, postPricingChange2026Trial). Going forward, new trial workspaces (with a billing plan start date on or after July 16, 2026) will receive no Audiences access. Workspaces created before July 16 on trial plans retain access temporarily via an Eppo flag, but that is a transitional mechanism, not a customer-facing entitlement. The docs claimed Trial workspaces had access to core Audiences features (CSV imports, people/company search, Clay table sends), which is no longer accurate for new trial users.

Deploy: clay-run/clay-base c8bdc8a...b5167da — https://github.com/clay-run/clay-base/actions/runs/29367699690

Source link(s)

• Deploy compare: https://github.com/clay-run/clay-base/compare/c8bdc8aa1f9a5d54e7bbc1b38c3b0d1ba30ff686...b5167da73612dad7ac772b8b64d20373334c5677
• Code: apps/api/migrations/20260713153000-disable-audiences-ga-for-trial-plans.js — sets enableAudiencesGA = false for ['trial', 'trialApril2023', 'postPricingChange2026Trial'] via UPDATE clay_admin.billing_plans
• Code: apps/api/v3/audiences/routes/audience-routes-common-utils.ts:19 — EXISTING_TRIAL_AUDIENCES_CUTOFF_MS = Date.UTC(2026, 6, 16) (July 16, 2026); isAudiencesEnabledForWorkspace() returns false for trial workspaces whose billing plan started on/after that date
• Code: libs/shared/src/billing/plan.ts:119 — TRIAL_PLAN_DEFAULT_FEATURE_FLAGS.EnableAudiencesGA: false confirmed
• Verifier verdict: PASS — migration is a permanent DB change (not a feature flag toggle), gating confirmed in code, Launch plan remains enabled (EnableAudiencesGA: true at plan.ts:165)

Uncertainties

None. The verifier returned PASS with file:line evidence for both the DB migration and the runtime gating logic. No Slack discrepancies found. The transitional Eppo grant for existing trials is an implementation detail not requiring customer-facing documentation.

Related observations

• The diff contains one unintended minor change: "Export batch size: ~10,000 records per sync" → "per batch" in the Export sync behavior section. Both phrasings are accurate; "per batch" is arguably more precise. Not re-pushed to avoid the one-push-per-file constraint.
• Other commits in this deploy (Audiences ROI drill-down panel, CPJ allowance balance on billing page, Enterprise-plan gate on observability API errors) do not require docs changes: ROI is not documented, CPJ allowance is not documented, and the observability API error message improvement has no existing doc page to update.
• Existing open PRs on docs/audiences.md: docs(audiences): document nested sub-field mapping in bulk enrichments #1558 (sub-field mapping), docs(audiences): add CSV export workaround via Add to workbook #1550 (CSV export via Add to workbook — mentions "trial workspaces" only in Clay table CSV export context, unrelated to plan access), docs(audiences): add FAQ clarifying dedup scope — Audiences only, not Clay tables #1547 (deduplication FAQ), docs(audiences): document Salesforce custom object export limitation and workaround #1528 (signal data FAQ), docs(audiences): add field-filter warning to Snowflake and BigQuery import steps #1507 (Snowflake/BigQuery field mapping), docs(audiences): add Databricks as beta import source #1485 (Databricks import). None cover the plan availability section modified here. Reviewer should reconcile at merge time.
• PR docs(audiences): add CSV export workaround via Add to workbook #1550 adds a note about "trial workspaces, CSV export from a Clay table may be capped to 50 rows" — this is Clay table CSV, not Audiences, and remains accurate regardless of Audiences plan access change.

Confidence: high

Closes DOC-1157